Inside Macintosh: QuickTime /

Chapter 2 - Movie Toolbox / Movie Toolbox Reference

Functions That Modify Movie Properties / Working With Movie Spatial Characteristics

GetMovieGWorld

Your application can determine a movie's graphics world by calling the GetMovieGWorld function.

pascal void GetMovieGWorld (Movie theMovie, CGrafPtr *port, 
                              GDHandle *gdh);

theMovie

Specifies the movie for this operation. Your application obtains this movie identifier from such functions as NewMovie, NewMovieFromFile, and NewMovieFromHandle (described on page 2-80, page 2-76, and page 2-78, respectively).

port

Contains a pointer to a field that is to receive a pointer to a graphics port structure. The Movie Toolbox returns a pointer to the movie's graphics port structure. Set this parameter to nil if you do not want this information.

gdh

Contains a pointer to a field that is to receive a handle to a graphics device structure. The Movie Toolbox returns a handle to the movie's graphics device structure. Set this parameter to nil if you do not want this information.

ERROR CODES

invalidMovie

-2010

This movie is corrupted or invalid

SEE ALSO

You can set a movie's graphics world by calling the SetMovieGWorld function, which is described in the previous section.